singleselection: Clarify docs

Mention persistence and sorting.

diff --git a/gtk/gtksingleselection.c b/gtk/gtksingleselection.c
index 63db37d0de5fdc513ec25123716939e670cf5b78..5d0172c7b1561b8f4ea8b3167cc83c7679f6a9f4 100644 (file)
--- a/gtk/gtksingleselection.c
+++ b/gtk/gtksingleselection.c
@@ -30,9 +30,14 @@
  * @Title: GtkSingleSelection
  * @see_also: #GtkSelectionModel
  *
- * GtkSingleSelection is an implementation of the #GtkSelectionModel interface 
+ * GtkSingleSelection is an implementation of the #GtkSelectionModel interface
  * that allows selecting a single element. It is the default selection method
  * used by list widgets in GTK.
+ *
+ * Note that the selection is *persistent* -- if the selected item is removed
+ * and re-added in the same ::items-changed emission, it stays selected. In
+ * particular, this means that changing the sort order of an underlying sort
+ * model will preserve the selection.
  */
 struct _GtkSingleSelection
 {